Saltar al contenido principal

Casos Infracciones Previsonales

Este endpoint devuelve las infracciones previsionales (casos de mora y multas relacionadas con cotizaciones) asociadas al RUT consultado en la cuenta de Sheriff.

  • No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
  • Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

  • URL: /helper/cobranzaLaboral/:rut/infraccionesPrevisionales
  • Método: GET

Parámetros

  • rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
'https://prod.api.thesheriff.cl/api/clients/v2/helper/cobranzaLaboral/12345678-9/infraccionesPrevisionales?page=1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
-H 'x-client-identifier: SheriffSecureClient-v1'

Manejo de paginación

  • page: Número de página a consultar. Por defecto es 1.Para incluir se debe ingresar en la ruta como query parameter: ?page=1.

Response

Success

  • Status code: 200

  • Example response body:

    {
    "success": true,
    "data": {
    "page": 1,
    "totalPages": 1,
    "cantidad": 2,
    "casos": [
    {
    "fecha": "10/10/2025",
    "nombreInstitucion": "Institución 1",
    "montoMorosidad": 2000,
    "mesesMorosidad": 1,
    "cotizacionesMorosas": null,
    "numeroInfraccion": "DECLARACIONES SIN PAGO"
    },
    {
    "fecha": "11/10/2025",
    "nombreInstitucion": "Institución 2",
    "montoMorosidad": 5000,
    "mesesMorosidad": 2,
    "cotizacionesMorosas": null,
    "numeroInfraccion": "DECLARACIONES SIN PAGO"
    }
    ],
    "ultimaActualizacion": "11-11-2025 11:11:11"
    }
    }

    A continuación se describen los campos devueltos en la respuesta JSON.

    CampoTipoDescripción
    successboolIndica si la operación fue exitosa.
    dataobjectObjeto con el número total de casos.

    Campos dentro de data:

    CampoTipoDescripción
    pagenumberPágina actual de resultados.
    totalPagesnumberCantidad total de páginas disponibles.
    cantidadnumberNúmero total de casos encontrados (ej: 1).
    casosarrayLista de objetos, uno por cada caso registrado en infracciones previsionales.
    ultimaActualizacionstringFecha última actualización de información

    Campos dentro de data:

    CampoTipoDescripción
    fechastringFecha del registro.
    nombreInstitucionstringNombre de la institución previsional que reporta la infracción.
    montoMorosidadnumberMonto expresado en formato numérico (ej: 2000).
    mesesMorosidadnumberMeses de morosidad reportados.
    cotizacionesMorosasnumberCantidad de cotizaciones morosas, puede ser null si no aplica.
    numeroInfraccionstringCódigo o descripción del tipo de infracción (ej: "DECLARACIONES SIN PAGO").

    Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

    Glosario de Términos

    Para una referencia completa consulta el Glosario de Términos. En particular, revisa las definiciones de numeroInfraccion, mesesMorosidad y cotizacionesMorosas, que son relevantes para este endpoint.

    Errores

    400 - Solicitud inválida

    {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
    }

    401 - No autorizado

    {
    "success": false,
    "code": 401,
    "error": "No autorizado"
    }

    403 - No tienes permiso para acceder a este recurso

    {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
    }

    404 - Recurso no encontrado

    {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
    }

    408 - Tiempo de espera agotado

    {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
    }

    429 - Demasiadas solicitudes

    {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
    }

    500 - Error interno del servidor

    {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
    }